Integrazione Fatture in Cloud

Questa guida spiega come collegare il tuo account Fatture in Cloud a Leo e come funziona la gestione di fatture e ricevute fiscali.

Prerequisiti

  • Account Leo con piano che include la funzionalità Fatture o Ricevute fiscali
  • Account Fatture in Cloud attivo

1. Collegare Fatture in Cloud

Avviare la connessione

  1. Accedi al pannello amministrativo di Leo (admin.tuodominio.it)
  2. Vai su Impostazioni → Fatture in Cloud
  3. Clicca su Collega account

Verrai reindirizzato alla pagina di autorizzazione di Fatture in Cloud.

Autorizzare Leo

Nella pagina di Fatture in Cloud ti verrà chiesto di autorizzare Leo ad accedere al tuo account. Leo richiede solo i permessi strettamente necessari:

  • Lettura clienti e fornitori — per associare i documenti fiscali al cliente corretto
  • Creazione e gestione fatture — per emettere fatture elettroniche e inviarle al SDI
  • Creazione e gestione ricevute fiscali — per emettere ricevute e marcarne lo stato di pagamento
  • Creazione note di credito — per stornare fatture già inviate
  • Lettura impostazioni account — per recuperare le aliquote IVA e i conti di pagamento configurati nel tuo account Fatture in Cloud

Leo non può modificare le tue impostazioni, leggere documenti ricevuti o accedere ad altri dati del tuo account.

Clicca Autorizza per completare il collegamento. Sarai reindirizzato automaticamente al pannello Leo.

Verifica del collegamento

Al termine del flusso OAuth Leo salva i token di accesso in modo cifrato e mostra lo stato Connesso nella pagina delle impostazioni. Da questo momento Leo può creare e inviare documenti fiscali per conto tuo.

2. Fatture

Creare una fattura

Le fatture possono essere create manualmente dalla sezione Fatture del pannello admin, oppure vengono generate automaticamente al completamento di un acquisto (se configurato).

Una nuova fattura viene creata in stato Bozza.

Finalizzare una fattura

Prima di poter inviare una fattura al SDI è necessario finalizzarla:

  1. Apri la fattura in stato Bozza
  2. Clicca Finalizza fattura
  3. Leo assegna automaticamente il numero progressivo (es. FATT-2025/001)

Una fattura finalizzata non può più essere modificata.

Inviare al SDI

Per trasmettere la fattura elettronica al Sistema di Interscambio:

  1. Apri la fattura in stato Finalizzata
  2. Clicca Invia al SDI
  3. Leo crea il documento su Fatture in Cloud che provvede alla trasmissione

Dopo l'invio lo stato diventa Inviata e il documento è visibile anche nel tuo pannello Fatture in Cloud.

Scaricare il PDF

Quando una fattura è in stato Inviata è possibile scaricare il PDF cliccando Scarica PDF. Il file viene generato da Fatture in Cloud.

Note di credito (storno)

Per annullare una fattura già inviata al SDI:

  1. Apri la fattura in stato Inviata
  2. Clicca Storna fattura
  3. Leo crea automaticamente una nota di credito su Fatture in Cloud con numerazione progressiva separata (es. NC-2025/001) e la collega alla fattura originale

3. Ricevute fiscali

Creare una ricevuta

Le ricevute vengono create nella sezione Ricevute del pannello admin e partono dallo stato Bozza.

Finalizzare una ricevuta

  1. Apri la ricevuta in stato Bozza
  2. Clicca Finalizza ricevuta
  3. Leo assegna il numero progressivo (es. RIC-2025/001)

Inviare una ricevuta

  1. Apri la ricevuta in stato Finalizzata
  2. Clicca Invia ricevuta

Se nel tuo account Fatture in Cloud sono presenti più conti di pagamento, Leo ti chiede di selezionare quale usare per questa ricevuta. In questo modo la ricevuta risulterà automaticamente saldata con il conto scelto.

Se non è configurato nessun conto di pagamento, la ricevuta viene inviata come non saldata e dovrai aggiornarla manualmente su Fatture in Cloud.

Scaricare il PDF di una ricevuta

Quando la ricevuta è in stato Inviata, clicca Scarica PDF. Il link viene recuperato direttamente da Fatture in Cloud.

4. Conti di pagamento

I conti di pagamento sono configurati direttamente nel tuo account Fatture in Cloud (es. "Cassa contanti", "Conto corrente bancario").

Leo li legge in automatico al momento dell'invio di ogni ricevuta. Non è necessario configurarli in Leo.

5. Rinnovare la connessione

Il token di accesso viene rinnovato automaticamente da Leo quando scade. Se la connessione risulta interrotta (es. token revocato manualmente da Fatture in Cloud), ripeti il flusso di collegamento dalla pagina Impostazioni → Fatture in Cloud.

6. Disconnettere l'account

Per disconnettere Fatture in Cloud vai su Impostazioni → Fatture in Cloud e clicca Disconnetti. I documenti già inviati rimangono visibili su Fatture in Cloud ma Leo non sarà più in grado di crearne di nuovi finché non viene ripristinata la connessione.